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HP OnLineJFS Installation Instructions for HP-UX 10.20 

Introduction 


Introduction 

This document contains instructions for installing the H P OnLineJ FS 
product (B3929BA or B5118BA) on H P-UX 10.20 systems. 

Read Before Installing 

If FtP OnLineJ FS is installed on an HP-UX 10.20 system that has been 
in use and on which H P-UX kernel patches have been applied, you must 
be aware of a serious problem that could compromise the i ntegrity of the 
system. 

Some H P-UX kernel patches contain fixes for both the basej FS file 
system (fileset vxfs-base-krn) and OnLineJ FS (fileset vxfs-adv-krn). 
At the time these kernel patches are installed, only the changes for the 
installed files will be applied to the system. Therefore if OnLineJ FSdoes 
not reside on the system at patch installation time, the changes to the 
OnLineJ FS library will not be applied. 

When OnLineJ FS is installed at a later date, the changes from the 
installed patches are not retroactively applied to OnLineJ FS. This can 
leave the system in an inconsistent state between the basej FS and 
OnLineJ FS software, which can cause such problems as data corruption, 
panics, or other unexpected failures. 


IMPORTANT To avoid these problems, you must first remove the latest patches 

containing the vxfs-adv-krn fileset, then install HP OnLineJ FS, and 
then apply the latest OnLineJ FS patches. During this procedure, you 
must boot a previous version of the kernel to ensure the sanity of the new 
system. 
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Installing HP OnLineJFS on HP-UX 10.20 


Installing HP OnLineJ FS on HP-UX 10.20 

Toinstall HP OnLineJ FS (B3929BA for servers, B5118BAfor 
workstations) on an existing H P-UX 10.20 system, follow the steps below. 

Step 1. Remove the latest patches that contain the vxfs-adv-krn fileset, with 
the exception of PH KL_16750 (s700) and PH KL_16751 (s800), which can 
remain on the system if they are already installed. 

List patches with swlist (1M) and remove patches with swremove(lM). 

The latest 10.20 H P-UX patches are listed on http://itrc.hp.com. 

As of August 1, 2001, the following patches must be removed before 
installing OnLineJ FS. These patches, along with other OnLineJ FS 
patches, will be reinstalled after OnLineJ FS has been installed. 

Table 1-1 OnLineJ FS Patches to Remove before 

OnLineJ FS Installation (as of August 1, 2001) 


s700 

s800 

PH KL_20357 

PH KL_20358 

PH KL_20096 

PH KL_20097 


Step 2. Turn off the autoboot feature with setboot (1M): 

# setboot -b off 

This will allow you to boot the previous version of the kernel that does 
not have HP OnLineJ FS configured into it (/stand/vmunix.prev). 

Step 3. Install HP OnLineJ FS (B3929BA or B5118BA) with swinstall (1M). 
Follow the instructions accompanying the media. 

Allow the system to reboot to I nteractive Boot mode (see hpux (1M)). 
Choose [Yjes for I nteracting with I PL and choose to reboot vmunix.prev. 

Here is an example of the bootup sequence. Note that the exact dialogue 
may vary depending on the hardware. 

Main Menu: Enter command > bo [primary-path\alternate-path] 
Interact with IPL (Y, N, Q)?> y 
Booting... 
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Installing HP OnLineJFS on HP-UX 10.20 


Boot 10 Dependent Code (IODOC) revision 153 
HARD Booted. 

ISL Revision 1.00.38 OCT 26, 1994 
ISL> hpux vmunix.prev 

Step 4. Reset the autoboot feature to ON after the system has rebooted. 

# setboot -b on 

After OnLineJ FS patches are installed, this will allow for booting the 
default /stand/vmunix which will contain theOnLineJ FS fileset and all 
applicable patches. 

Step 5. Install the latest OnLineJ FS patches using swinstall (1M). 

The latest 10.20 H P-UX patches are listed on http://itrc.hp.com. 

The table below lists the patches to be installed as of August 1, 2001. 
This list will change each time a new patch containing the vxfs-adv-krn 
fileset is created or if any of the patches is superseded. 

Table 1-2 OnLineJ FS Patches as of August 1, 2001 


s700 

s800 

PH KL_16750 

PH KL_16751 

PH KL_13093 

PH KL_13094 

PH KL_20357 

PH KL_20358 

PH KL_20096 

PH KL_20097 

PH KL_24065 

PH KL_24066 


The HP-UX Base Kernel patch (PHKL_16750 or PHKLJL6751) mayor 
may not be installed on the system before installing OnLineJ FS, but it 
must be installed before installing patches PHKL_20096 or 
PH KL_20097 and PH KL_24065 or PHKL_24066, to satisfy a dependency 
check. 


The system wi 11 reboot. 

Step 6. After the system has had both OnLineJ FS and all required patches 
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Installing HP OnLineJFS on HP-UX 10.20 


installed, verify that all files are at their correct revision levels with the 
following command: 

# what /usr/conf/lib/libvxfs_adv.a /usr/conf/lib/libdmapi.a 


NOTE Some files may have patch-1 Ds of patches that have not been installed on 

your system. This is normal. 


For s700, when the above patches are applied, the output will include the 
following files and corresponding patch-1 Ds, along with other 
information that is not shown here: 

kdm_core.c (PHKL_20096) 
vx_dio.c (PHKL_20355) 
vx_dirsort.c (PHKL_13093) 
vx_dmattr.c (PHKL_19529) 

vx_full.c (PHKL_1952 9) 

vx_kdmi.c (PHKL_19529) 
vx_reorg.c (PHKL_24065) 
vx_sample_dmattr.c (PHKL_19529) 
vx_snap.c (PHKL_20357) 

For s800, when the above patches are appl ied, the output wi 11 i ncl ude the 
following files and corresponding patch-1 Ds, along with other 
information that is not shown here: 

kdm_core.c (PHKL_20097) 
vx_dio.c (PHKL_20356) 
vx_dirsort.c (PHKL_13094) 
vx_dmattr.c (PHKL_19530) 

vx_full.c (PHKL_19530) 

vx_kdmi.c (PHKL_19530) 
vx_reorg.c (PHKL_24066) 
vx_sample_dmattr.c (PHKL_19530) 
vx_snap.c (PHKL_20358) 
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